•Finished upgrade to THINK C 6.01. Nearly all of the VideoToolbox projects appear twice. Files with the extension ".π5" are in version 5 format, and those with the extension ".π" are in version 6 format. THINK C 6 will read either format of project file (converting it to the new format), but THINK C 5 will say "Unknown error ID=-192" if you try to open a version 6 project. In either case, follow the instructions in VideoToolbox.c to produce the precompiled header "VideoToolbox.pre", since it must be produced by your version of the compiler. (Note that the THINK C 5 project files have not been updated since June '93, and are becoming seriously out of date.) I suggest all users of the VideoToolbox upgrade to THINK C 6.01.
•Added GetVersionString.c, based on Joseph Laffey's GetVersStr.c, which gets the application's version from its 'vers' resource. Thanks!
•Added new sections on "HIGH FRAME RATES" and "MORE THAN 8-BIT DACS" to the "Video synch" file.
•Corrected capitalization of all textual references to the commercial "MATLAB" program. Renamed MatlabMain.h to MATLABMain.h and ReadMatLabFile.c to ReadMATLABFile.c. These changes are innocuous because only the filenames were changed and the only change was in the capitalization, which is ignored by the Macintosh file manager.
•The demo Quitter now goes away quietly if you hit Cancel.
CHANGES DURING 11/93:
•Added new section on "SYNCHING MULTIPLE VIDEO CARDS TO EACH OTHER" to the "Video synch" file.
CHANGES DURING 10/93:
•Updated Quick3 to use either the old CricketGraph or the new CA-CricketGraphIII.
CHANGES DURING 9/93:
•Added PixMapToPICT.c, which saves a section of a PixMap as a PICT file.
•Renamed TranslateText.c to TranslateLinefeeds.c and enhanced it to work with arbitrarily large text strings and to implement macros as inline code.
•Added MATLABMain.h, which should be #included in the main C file of your THINK C MATLAB project.
•Deleted Assign.h, after merging its contents into VideoToolbox.h.
•Added symbol MAC_C to VideoToolbox.h to allow VideoToolbox.h (and many C files) to be compiled even on non-Macintosh computers. MAC_C is true only if the compiler supports the Macintosh extensions to C, e.g. the keyword "pascal".
•Added GetTimeDateString.c.
•Moved Require() from PrintfExit.c to Require.c. Enhanced Require.c to check for consistency of sizeof(int) among Require(), the (possibly precompiled) VideoToolbox.h header, and the Standard C library.
•Renamed the precompiled header from "VideoToolbox" to "VideoToolbox.pre". Think of ".pre" as standing for both "precompiled" and "prefix", which is the window you type the #include command into. You should use VideoToolbox.c to create "VideoToolbox.pre". You may use VideoToolboxMATLAB.c to create "VideoToolboxMATLAB.pre".
•Added PrintWrappedText() and PrintWrappedTextToFile() to BreakLines.c.
•Enhanced Assign.c by adding new routines written by David Brainard: OpenCalFileWrite, OpenCalFileRead, OpenCalFileReadAndCheck, AppendDescriptions, CopyDescriptions, AllocateDescriptions, FreeDescriptions, NumberOfDescriptions, NullDescription, and IsNullDescription.
CHANGES DURING 8/93:
•Enhanced Assign.c to support arrays with an arbitrary number of dimensions (up to ASSIGN_DIMS) and dynamic dimensioning and allocation of arrays based on the assignments that appear in the assignment file. Renamed "Variable" to "Description". Renamed most of the routines. The header file Assign92.h provides for backward compatibility.
•Polished GetWindowDevice(), based on answer from DEVSUPPORT, for better compatibility with future versions of 32-bit QuickDraw.
CHANGES DURING 7/93:
•The MATLAB symbol is now defined as 1 or 0 instead of being defined or left undefined. The advantage of this approach is that the MATLAB symbol can now be used as an argument in an ordinary if statement, which is much more readable than #if.
•All routines now call SwapMMUMode() only if gestalt32BitCapable is true.
•Enhanced GDDacSize() in GDVideo.c to return 8 unless the driver provides a valid gamma table, for compatibility with video drivers, e.g. the Radius PowerView, that return invalid gamma tables.
•TimeVideo 2.5.2 recompiled with new GDDacSize().
CHANGES DURING 6/93:
•Upgraded to THINK C 6.
•Assign.c: Removed all Macintosh dependencies, leaving pure Standard C. Added support for shortDoubleType and arrays of stringType.
•New IsCmdPeriod.c accepts an event record and returns true or false, indicating whether the user has hit command period. Should work even on international systems that do keyboard remapping.
•New OpenPreferencesFolder.c opens the Preferences folder in the System Folder, creating it if necessary.
•PixMapToPostScript.c now accepts a pixmap handle instead of a pointer, relieving the user of the responsibility of making sure that the handle was locked before being dereferenced. Fixed silly bug, introduced 5/27/93, that suppressed all hex data.
•In ReadMatLabFile.c: Added LoadNamedMatIntoShorts and LoadNamedMatIntoDoubles. Renamed LoadMatShorts and LoadMatDoubles to LoadNextMatIntoShorts and LoadNextMatIntoDoubles.
•SetPixelsQuickly.c is now callable as a MatLab resource, thanks to detective work and tricky work-around by David Brainard.
CHANGES DURING 5/93:
•Due to a reorganization of the info-mac ftp site, the latest VideoToolbox is now at info-mac/Development/SourceCode/.
•Assign.c is the new name for the former ReadAssignments.c, which has been significantly enhanced. This runtime C interpreter reads and executes any text "assignment" file that contains only C assignments and comments. It can also write an assignment file, making the assignment file a portable way of recording calibrations and experimental parameters. New features include optionally ignoring unknown variables, support for arrays, optional return of an error code in place of calling PrintfExit, and checking of name syntax.
•Added MultipleChoice.c, accepts one character response (with default) and spells out whole answer. YesOrNo(), formerly in kbhit.c, accepts y/n and spells out "Yes" or "No".
•Enhanced GetWindowDevice() to support GWorld's.
•Updated Quick3 and CalibrateLuminance to use version 2 of Numerical Recipes in C.
•TimeVideo 2.5 tests all video devices on any Mac running System 6.05 or later. It tests gray and color modes, and measures and reports the gray-mode color-transformation matrix. It no longer assumes any particular correspondence between the video mode number and the pixel size. Many small bug fixes.
•SetEntriesQuickly.c now respects the setting of the device's gray/color mode, and maps to gray when appropriate. Changed prototype of macltset to specify the red, green, and blue arrays as "unsigned short" instead of "short".
•Luminance.c: If the driver is in gray mode (i.e. not color) then LoadLuminances maps rgb to gray by simply copying the green component to the red and blue components.
•GDVideo.c: Changed GDPrintGammaTable() to accept a simple file pointer instead of an array of two file pointers.
•GrabSlotDrivers now checks for presence of the Slot Manager, in response to bug report by Jonathan Brecher.
CHANGES DURING 4/93:
•Updated all projects and "Read me".
•Added explanation of tiling to PixMapToPostScript.c.
•GetPixBaseAddr32(PixMap **pm) returns the 32-bit address of the pixels/bits in a pix/bitmap. In RectToAddress.c.
•SetEntriesQuickly.c no longer requires a 68020.
•MaximizeConsoleHeight.c now fully supports 1-bit QuickDraw.
•Deleted obsolete AddressToSlot and AddressToScreenDevice from GetScreenDevice.c.
•Merged GDFrameRate.c and GDTimeClut.c to produce GDTime.c. Deleted obsolete GDFramesPerClutUpdate, GDClutUpdateRate, and GDTimeClutUpdate.
•GDCOLORS(device) is gone because its answer was misleading when in 16-bit or 32-bit mode. Instead, use either GDClutSize(device) or GDColors(device), in GDVideo.c, but take care to choose the right one, since they're not equivalent when in more-than-8-bit modes.
•GDVideo.c: Removed assumption, in all routines, that there is any particular correspondence between the video mode number and the pixel size. New GDHasMode(device,mode,&pixelSize,&pages) tells you whether a particular video mode is supported by your video device. Added GDPrintGammaTable(). Deleted GDModeName().
CHANGES DURING 3/93:
•Made RectToAddress compatible with the initial versions of 32-bit QuickDraw, in which GetPixmapBaseAddr() did not work.
•Enhanced TimeVideo, producing a more comprehensive and intelligible report, and subsuming the former TestCluts, which is now gone.
•GDSetEntriesByType(device,...) checks the (**device).gdType field and calls GDSetEntries, GDDirectSetEntries, or nothing, as appropriate. In GDVideo.c.
•GDSetEntriesByTypeHighPriority does the same, but at high processor priority, forcing the driver to behave synchronously. In GDVideo.c.
•GDInfo.c collects useful information about a video device. In GDVideo.c
•IdentifyVideo(device) returns a descriptive C string. In Identify.c,.
•Added the constant MAX_SCREENS=8 to VideoToolbox.h
•GDSaveGamma(device) saves a copy that GDRestoreGamma(device) later uses to restore the gamma table. In GDVideo.c.
•Added UnclipScreen(device), RestoreScreenClipping(device), SquareCorners(device), and RestoreCorners(device) to HideMenuBar.c, to extend the clipping region to include the WHOLE screen.
•GDOpenWindow/GDDisposeWindow call GDSaveGamma/GDRestoreGamma and UnclipScreen/RestoreScreenClipping.
CHANGES DURING 2/93:
•Fixed endless loop in PatchMacIIciVideoDriver in GDVideo.c that hung up any program that called GDGetEntries, including the demos TestGDVideo and TestSetEntriesQuickly.
•Enhanced PatchMacIIciVideoDriver to deal with ROM- as well as RAM-based video drivers.
•Fixed SetEntriesQuickly to work correctly on Toby Video Card, Macintosh Display Card 8•24, and to work in 16-bit mode on Quadra.
•VideoToolbox.c explains how to create a precompiled header, for tenfold faster compiles.
•Greatly increased the number of headers included by VideoToolbox.h, so that most C files can now include just the VideoToolbox.h header.
•Added tiny new demo, Grating.c, that shows how to load the clut and display a grating.
•Added SetPixelsQuickly.c to quickly peek or poke a row of pixels, bypassing the color tables. It's more than ten times faster than using SetOnePixel.c, which is now obsolete. This is the fastest way to get at the pixels in an image, for image processing or synthesis. Works with bitmaps and pixmaps and any size of pixel. Try the demos Grating and FlickeringGrating.
•GDOpenWindow now creates a full-screen window even on the main screen.
•Added window=GDOpenWindow1(device) and GDDisposeWindow1(window), which work with a WindowPtr instead of a CWindowPtr, for less hassle with casting.
•AddExplicitPalette(window), in GDOpenWindow.c, adds a palette with all colors marked as explicit, so that you can use PmForeColor and PmBackColor to specify literally what numbers you want to put into your pixels in drawing operations like EraseRect() and DrawString().
•Added PrintfExit.c, which prints out an error message and exits. Replaced all calls to exit() in the VideoToolbox by calls to this routine, so many projects will need to add it.
•Require.c tests for any required fpu, cpu, and version of QuickDraw, and fails gracefully if they're absent.
•All demos now call Require.c to test for presence of any required fpu, cpu, and version of quickdraw, instead of crashing.
•Enhanced GDUncorrectedGamma() in GDVideo.c to work correctly with video devices that use any version of the gamma table. This might have caused TestCluts to report spurious driver errors.
•Replaced IdentifyCompiler.c and IdentifyMachine.c by the new Identify.c. Added IdentifyVideo(device) and IdentifyModel().
•Renamed TestSetEntriesQuickly to TestCluts, and enhanced it to save detailed results in file.
•Enhanced CopyBitsQuickly to return a nonzero int if an error occurred.
•Added an image-multiplication mode to CopyBitsQuickly, and enabled it on 2/18/93.
•Added SwapPriority() to SetPriority.c, to be used just like SwapMMUMode().
•ConvolveX.c now rounds to nearest integer, and supports 32-bit video addressing.
•Renamed the file MatLab.c to ReadMatLabFile.c, though the functions themselves are unchanged.
•Introduced MATLAB conditional into VideoToolbox.h, to support creation of MatLab external code resources, as implemented by David Brainard.
CHANGES DURING 1/93:
•Enhanced PatchMacIIciVideoDriver in GDVideo.c to deal with ROM- as well as RAM-based video drivers.
•Renamed CopyQuickdrawGlobals to CopyQuickDrawGlobals. Old spelling is still supported for backward compatibility.
•Enhanced the cache-staleness tests in SetOnePixel.c.
•GDGetEntries() in GDVideo.c now returns statusErr instead of calling any video driver that is known to crash.
•Deleted GDIndentify.c after merging its contents into GDVideo.c.
•Spruced up the documentation in GDVideo.c.
•TimeVideo 1.09 works on virtually any Mac, even if Color QuickDraw is missing. Thanks to jonathan brecher for reporting that it crashed without Color QuickDraw.
•Enhanced GDMovieRate() in GDFrameRate.c to work even when Color QuickDraw is absent.
•Fixed bug so that CopyBitsQuickly and RectToAddress now handle BitMaps correctly.
•Added a list of known driver bugs to the "Video synch" file. Also explained to Mac IIci users how to fix their built-in video driver's GetEntries bug.
•Added PatchMacIIciVideoDriver(), in GDVideo.c, to automatically patch the buggy driver (until reboot), the first time GDGetEntries is called, so that we can finally read the Mac IIci's clut.
•Added utilities GetVideoDrivers and GetSlotDrivers, which copy all drivers into resource files, for subsequent perusal in ResEdit.
•Fixed bug in GetPixmapPixel() in SetOnePixel.c.
•Added MatLab.c to read and write MATLAB binary data files.
CHANGES DURING 12/92:
•Changed "CLUT" to "Clut" in all symbolic names.
•Added GDClutSize() to GDVideo.c, returning the current number of entries in the video driver's clut.
•Enhanced TestSetEntriesQuickly to also test the driver, and made it compatible with System 6 as well as 7.
•Doubled the speed of all the routines in SetOnePixel.c by caching parameters of the Bit/Pixmap. Programs that modify the Bit/Pixmap structure, e.g. changing the origin, should invalidate that cache by calling Set/GetPixmapPixel with a NULL Pixmap pointer. The demo FlickeringGrating benefits from this increased speed.
•Moved Luminance.doc from VideoToolboxSources to Notes folder.
•Minor enhancement to Luminance.c to add support for 9-bit dacs (and less-than-8-bit dacs), but the package has still only been tested with 8-bit dacs.
•Fixed minor error in Luminance.c that could prevent using the THINK C Debugger inside SetLuminanceRange(). (Thanks to Wei Xie and Ken Alexander for reporting the bug and fix.)
•Renamed GDLinearGamma to GDUncorrectedGamma in GDVideo.c, to more accurately describe its function, and enhanced it to support all DAC sizes. For backward compatibility, VideoToolbox.h defines GDLinearGamma as an alias for GDUncorrectedGamma.
•Enhanced RestoreCluts() so that it always works.
•Enhanced GDRestoreDeviceCLUT(). Passing a NULL argument now restores cluts for all the screens. Now renamed GDRestoreDeviceClut to be consistent with Apple's capitalization of RestoreDeviceClut.
•Introduced (12/2) and removed (12/8) a bug that disabled CopyBitsQuickly.
•Added SetEntriesQuickly.c, written by Raynald Comtois, Peter Lennie, Bill Haake, and Denis Pelli, that provides fast clut load for many popular video cards, bypassing the video driver. That file also includes macsetlt() and WaitForBlanking(). Added new demo, TestSetEntriesQuickly.c, and deleted TestCLUT.c, which it supercedes.
•After extensive testing, released version 1.0 of TimeVideo.
•Fixed minor Quick3 bug that could cause the last character in a data file to be missed. (Error was in MyFGets.c.)
CHANGES DURING 11/92:
•Fixed bug in VBLInstall.c that could occasionally cause crash at program exit (e.g. in TimeVideo).
•Fixed bug in Quick3 the prevented opening data file unless in same directory as Quick3.
•Removed “Goodies from others” folder, prior to posting in public archives.
•Eliminated ConvolveY.c, by incorporating it into ConvolveX.c.
•InverseNormal(0) now returns -INF, and InverseNormal(1) returns INF.
CHANGES DURING 10/92:
•Added VLambda.c which returns the interpolated visual sensitivity, scotopic or photopic, based on the Wyszecki and Stiles tables.
•Debugged TimeVideo.c and GDFrameRate.c to work on all Macs under Systems 6 and 7, and made many minor enhancements.
•New "Video synch" file discusses how to synchronize a program to a video card. (Was briefly called "Video".)
•Enhanced VBLInstall.c to automatically create and dispose of the timer needed by FrameSubroutine, for painless frame synchronization. This will REQUIRE CHANGES to programs written using the 9/92 version of the VideoToolbox, since at that time it was the user's responsibility to allocate and dispose of the timer. To alert you to the change, "FrameSubroutine" is no longer "published" in VideoToolbox.h. Just pass NULL in the subroutine field of the VBLTaskAndA5 struct that you pass to VBLInstall. (You no longer need to pass anything in the "ptr" field.)
•Tweaked MaximizeConsoleHeight() to prevent clipping at bottom of screen.
•Added GDRestoreDeviceCLUT() to GDVideo.c
•Sped up PixMapToPostScript.c, and added support for PixMaps that require 32-bit addressing (e.g. video screens).
CHANGES DURING 9/92:
•Added randUL() to randU.c, returning a 32-bit random number.
•Added nrandU(i) and nrandUL(i) to nrand.c, returning random samples (of type unsigned short or long) from the range [0,i-1].
•VBLInstall.c's default behavior now is to discard bogus interrupts, to allow reliable video frame synchronization on all video cards. (Suggested by Raynald Comtois.)
•TimeVideo is significantly enhanced. Try it.
•GDFrameRate.c now always returns true frame rate. Added GDVBLRate() and GDMovieRate().
•NewPaletteManager() in QD32Exists.c has been made slightly more conservative.
•Fixed GetDeviceSlot() to return -1 (instead of 0) if GDHandle is invalid, since 0 is a valid slot.
CHANGES DURING 8/92:
•Added Timer.c, an accurate reentrant interval timer based on Apple's Time Manager. StopTimer() returns the time in µs that elapsed since calling StartTimer(). Deleted obsolete TimeIt.c.
•New demo TimeVideo checks out the timing of all your video hardware and saves the results in a data file. Added a new section to the Read Me file, on "SYNCHRONIZING YOUR PROGRAM TO YOUR VIDEO CARD". Everyone that cares about timing should run TimeVideo.
•Added GDFrameRate.c, which measures the frame rate of a video device in Hz; GDFramesPerCLUTUpdate() measures how long it takes to update the clut, in frames. Updated TestGDVideo to use these routines.
•Added TrapAvailable.c, from Apple.
•Added VBLInstall.c that implements a once-per-video-frame interrupt suitable for use with all video devices.
•Added PrintAssignment() to ReadAssignments.c, to print out the value of a variable, as an assignment statement, suitable for reading by the ReadAssignment routines.
•Deleted obsolete GDPrintf.c. Moved MyFgets.c to Quick3 folder.
•All routines now check for 8-bit quickdraw before using GDevices.
•GetDeviceSlot() now returns -1 if none, since zero is a legal slot.
CHANGES DURING 7/92:
•Added suggestion to Read Me file that you enable THINK C’s "Require prototypes" option (under "Language Settings").
•Happily discovered that all the demos are compatible with 32-bit addressing and virtual memory.
•Requests for copies of the VideoToolbox disk no longer need be accompanied by a blank floppy. Email and reprint requests are fine. Be sure to include your mailing address, as the VideoToolbox is too big for email.
•Added FlushCacheRange.c from Apple, which provides a machine-independent way of flushing your processor's instruction and data caches.
CHANGES DURING 6/92:
•Minor enhancements of CalibrateLuminance.c and GetVoltage.c.
CHANGES DURING 5/92:
•Expanded the documentation of ReadAssignments.c.
CHANGES DURING 4/92:
•SndPlay1.c plays sounds asynchronously, i.e. while you're doing other stuff.
•CreateTrialSnds.c creates some snd resources to make sounds that I find well suited to psychophysical testing.
•Eliminated spurious inclusion of nr.h header file in Binomial.c.
•Replaced old SetIPixel.c by new SetOnePixel.c, which is now handles bitmaps and pixmaps with any pixel size.
•Added RestoreDeviceCluts.c to automatically restore all screens to normal.
•Added BinomialSampleQuickly() to Binomial.c.
•Added NoiseVBL to the Demo folder. It shows how to synchronize your program to the video monitor by means of the vertical blanking level interrupt.
•Enhanced ReadAssignments.c, mainly by adding ReadAssignmentBlock(), which reads until it finds a blank line.
•MakeNoise.c: Eliminated obscure bug that would cause a crash if the supplied PixMap had negative left or top bounds.
•Removed the obsolete folder called (Header files for THINK C 4). Contact me if you need it.
CHANGES DURING 3/92:
•QD32Exists.c now uses Gestalt(), if available, instead of SysEnvirons().
•mc68881.h defines MPW C's mc68881 and mc68020 preprocessor symbols for THINK C, so your programs can use them in "if" statements without worrying about which compiler you're using. The symbols are 1 (i.e. true) if the compiled code requires the chip (or better) and 0 otherwise.
•Made two changes to the Numerical Recipes files, correcting one prototype and making another more explicit, to satisfy the now more stringent testing of THINK C 5. (You must buy your own copy of the Numerical Recipes and make the changes. See my "Read Me" file.)
•Updated the 68881 compiler option test in all the demos for compatibility with THINK C 5.
•Updated Quick3 for compatibility with VideoToolbox, and made it faster (mostly by defining preprocessor substitutions in the header file Quick3.h).
•GetScreenDevice.c now skips inactive devices, for compatibility with the "Blind Monitors" program available from CompuServe.
CHANGES DURING 2/92:
•Fixed bugs in GetWindowDevice() in GetScreenDevice.c
•Made optional the myGDHandle argument to GDDisposeWindow() in GDOpenWindow.c
•Added Normal2D() etc. to Normal.c
CHANGES DURING 1/92:
•Renamed xxxPDF routines to xxxPdf.
•Rewrote IsNan() for speed and added IsInf() and IsFinite(). IsNan() now returns the index (1..255) of the NAN, or zero if not a NAN.
•Added CopyQuickdrawGlobals.c for THINK C users of both console and MacTraps.
CHANGES DURING 9-12/91:
•Added TitleBarHeight.c, which returns the height of a window's title bar, in pixels.
•Added UniformSample() in Uniform.c providing a random sample from the interval [0,1).
•Added IsInf() routine to IsNan.c file and IsNotFinite() macro to VideoToolbox.h.
•Rewrote IsNan(), making it five times faster.
•Added new routine to Luminance.c: IncrementLuminance() is used to obtain the lowest possible contrast.
CHANGES DURING 8/91:
•New routine RandFill(address,bytes) fills a buffer with random bits very quickly, about 1 µs/byte on a Mac IIci.
•New routines: ReadAssignments.c and ReadLuminanceRecord.c. ReadAssignments is a runtime C interpreter that only accepts assignments and comments.
•Updated everything to be compatible with THINK C 5.0. Still works with version 4 as well.
•All sources in the VideoToolboxSources folder (except kbhit.c) now compile without error under MPW C 3.2.
CHANGES DURING 7/91:
•Most sources now compile without error under the MPW C 3.1 compiler. SetPriority has been rewritten and is now compatible with MPW C. kbhit.c is still incompatible with MPW C. CopyBitsQuickly.c generates slower code when compiled by MPW C than when compiled by THINK C.
CHANGES DURING 6/91:
•CalibrateLuminance. Fixed bug in GetALuminance.c pointed out by Sujeet Paul that caused CalibrateLuminance to fail unless an A/D card was available.
•TimeIt.c now carries a warning that the timing is inaccurate, about 10% too low, for reasons explained by Apple in the Time Manager chapter of Inside Mac VI.
•TestGDVideo.c now times how long it takes to load the clut. It seems that all the new Apple video cards take 30 ms (two frames!!) to load the clut.
CHANGES DURING 5/91:
•GetVoltage.c now automatically tries to lower the gain if a voltage overflow occurs.
•New routine: IsNan.c allows you to test whether your double variable contains a Not A Number code instead of a legal number.
CHANGES DURING 4/91:
•MakeNoise.c now has a new routine MakeNoise1 with a simpler interface that allows you to specify whether or not to randomize phase.
•CenterRectInRect.c has two new trivial but handy routines for playing with rects: OffsetRectTile and RectInRect.
•PixMapToPostScript will convert a grayscale image to a postscript file suitable for printing on a LaserWriter or Linotype.
•QD32Exists.c has two new routines: QD8Exists() and NewPaletteManager() to determine existence of color quickdraw and the new palette manager (documented in Inside Mac volume VI, still unreleased). Added NewPaletteManager() call to several demos, to enhance compatibility. Thanks to Chuck Stein at UC Santa Cruz for alerting me to the need to check for the existence of the new palette manager.
•RectToAddress (used by CopyBitsQuickly). Fixed obscure overflow bug that resulted in returning the wrong address (i.e. wrong rect) when rect.left*pixelSize exceeded 32K. Thanks to Brady Duga at the Center for Visual Science for reporting the bug.
CHANGES DURING 3/91:
•PlotXY.c was re-written. It's now re-entrant and allows dashing of curves and plotting of symbols. However, the calling interface has changed, requiring minor changes in any program that calls it.
CHANGES DURING 2/91:
•RectToAddress, and hence CopyBitsQuickly, no longer requires color quickdraw, so they should now work on all Macs.
•Added SetMouse.c and HideMenuBar.c as published in THINKin' CaP, 1(2):28-29, Fall 1990 by SPLAsh Resources.
•Enhanced GDIdentify to support ROM-based video drivers, as in the Mac IIsi.
•Modified TestGDVideo so as to avoid a mysterious crash in GDGrayPage that occurred only if the program were run immediately after rebooting. Also replaced an old bug fix in GDGrayPage() in GDVideo.c. The bug is in the Apple video driver for the original "Toby" video card.
CHANGES DURING 1/91:
•Enhanced Binomial.c. The calls to BinomialUpperBound & BinomialLowerBound now take their arguments in a new order, and have an additional argument, the desired confidence of the interval.
•Added TimeIt.c written by Bill Tuttle, and downloaded from Compuserve.
CHANGES DURING 1990:
•Fixed a trivial bug in CalibrateLuminances that resulted in LuminanceRecords that had LR.VMax=0 and LR.coefficients=0. This would cause divide-by-zero errors when the LuminanceRecords were later used by the Luminance.c routines. You can fix any offending LuminanceRecord.h file by replacing the zeroes with the correct values: LR.VMax=255 and LR.coefficients=9. This bug was present for a very short time and will have affected very few people (possibly only me).
•Hundredfold increase in speed of SetLuminance. On a Mac II, SetLuminances now computes an entire clut in 8 to 29 ms, depending on the luminance range. (The time grows with the number of variable DACs, which grows with the size of the luminance range.) A dynamic display uses a new clut for each 15 ms frame, so a Mac II can now compute low-contrast cluts on the fly in real time. The Mac IIci is about twice as fast as the Mac II, and the Mac IIfx is about twice as fast as the IIci, so they should be able to compute even high-contrast cluts in real time. Of course, you can still pre-compute the cluts if you prefer.
•Added new THINK C header file Color.h to "Goodies from others" folder. You need these in order to use many of the new features of 32-bit Quickdraw. Deleted the now-obsolete QDOffscreen.h from VideoToolboxSources. If you use these calls then you should call the routine Q32Exists() at the beginning of your program to make sure 32-bit Quickdraw is present and quit gracefully with an explanatory error message if it isn't.
•SetLuminancesAndRange() adds two more arguments allowing separate specification of the range of this particular clut and the total range that the observer will see (e.g. over time). I suggest using this instead of SetLuminances(), especially for dynamic displays.
•Deleted AllocatePixMap.c since it's been superceded by Apple's NewPixMap() and NewGWorld().
•Added Quick3 psychometric fitting software to Utilities folder. Quick3 fits any simple model to frequency-of-seeing data. It presently uses the Weibull function (popularized in vision by Frank Quick), but it would be easy to substitute any other.
•VideoTest is now compatible with: NuVista & Mac IIci built-in video.
•Apple has renamed the control and status calls, so I followed suit: GDGetPageBase replaces GDGetBaseAddr GDReset replaces GDInit GDGrayPage replace GDGrayScreen GDGetPageCnt replaces GDGetPages
•SandStorm enhanced & removed the last lingering bugs. Now works fine on Mac IIci.
•Added a second suggestion to "Notes.:Improve THINK C profiler"
•Cosmetic updating of Luminance.c & .h and CalibrateLuminance.c for better consistency with Pelli & Zhang (1991). Luminance.c now checks for out-of-range entries.
•CalibrateLuminance.c was substantially enhanced, and now allows calibration of single-monitor systems.
•Polished code in GetVoltage. Now more modular and general.
•GetVoltage now looks for and finds the Data Translation A/D in any slot.
•SetIPixel() and GetIPixel() now check for the presence of 32-bit QuickDraw, and--if it's present--access video memory in 32-bit mode. This makes the calls compatible with 32-bit video cards, e.g. NuVista.
•MakeNoise now uses the current ForeColor and BackColor to make the noise.
•Fixed bug in GDVersion() in GDIdentify.c that gave wrong version numbers for some drivers.
•MakeNoise and AllocatePixMap were made compatible with 32-bit QuickDraw.
•CopyBitsQuickly() didn't work on 32-bit devices (e.g. NuVista) unless 32-bit QuickDraw was installed. This has been fixed.
•The demos now check for any required hardware before running, and fail gracefully instead of crashing if the requirements are not met.
•The VideoTFB.c routines now check that the card is indeed a TFB card before trying to access its registers.
•Most of the programs have been made compatible with MPW C 3.1.
•MakeNoise.c now accepts a real expansion factor instead of just an integer.
•TestGDVideo.c now special cases out all the known driver bugs, e.g. GetEntries on the Mac IIci built-in video driver. Apple has acknowledged that this is a bug in their driver. I expect it will be fixed in the next System release after 6.05.
•I've changed the program and file names to conform more consistently with the Apple naming convention. Subroutine names start with a capital letter. Variables start with a lower case letter. Subsequent words in multi-word names also start with a capital, e.g. the program MakeNoise() and the variable frameBytes. Defined constants are in all capitals, with multiple words separated by an underscore, e.g. NOISE_FRAMES.
•GDOpenWindow and GDDisposeWindow now declare the window pointer as CWindowPtr instead of WindowPtr. This only affects the compiler's type checking. It does not affect the operation of the program, as they've been color windows all along. It's okay to cast them back to the old fashioned WindowPtr.
